home *** CD-ROM | disk | FTP | other *** search
/ X User Tools / X User Tools (O'Reilly and Associates)(1994).ISO / sun4c / archive / tcltk.z / tcltk / man / catn / lappend.n < prev    next >
Text File  |  1994-09-20  |  1KB  |  67 lines
  1.  
  2.  
  3.  
  4. lappend(n)            Tcl Built-In Commands
  5.  
  6.  
  7.  
  8. _________________________________________________________________
  9.  
  10. NAME
  11.      lappend - Append list elements onto a variable
  12.  
  13. SYNOPSIS
  14.      lappend _v_a_r_N_a_m_e _v_a_l_u_e ?_v_a_l_u_e _v_a_l_u_e ...?
  15. _________________________________________________________________
  16.  
  17.  
  18. DESCRIPTION
  19.      This command treats the variable given by _v_a_r_N_a_m_e as a  list
  20.      and  appends  each  of the _v_a_l_u_e arguments to that list as a
  21.      separate element, with spaces between elements.  If  _v_a_r_N_a_m_e
  22.      doesn't  exist,  it is created as a list with elements given
  23.      by the _v_a_l_u_e arguments.  Lappend is similar to append except
  24.      that  the  _v_a_l_u_es  are appended as list elements rather than
  25.      raw text.  This command provides a relatively efficient  way
  26.      to  build  up large lists.  For example, ``lappend a $b'' is
  27.      much more efficient than ``set a  [concat  $a  [list  $b]]''
  28.      when $a is long.
  29.  
  30.  
  31. KEYWORDS
  32.      append, element, list, variable
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63. Tcl                                                             1
  64.  
  65.  
  66.  
  67.